15. Timers en klokken 


Timers 

Timers hebben veel toepassingen. We kunnen ze gebruiken om een tijdsinterval te 
meten, om PWM signalen te genereren of om een signaal te geven als een tijdsduur 
verstreken is. Voorlopig heeft MicroPython alleen de eenvoudige toepassing 
geïmplementeerd: het periodiek oproepen van een functie Voor het werken met een 
timer gebruiken we klasse Timer uit library machine. 


Declaratie van de timer 

De RP2040 heeft één hardware timer, MicroPython gebruikt die voor interne 
processen. In een programma kunnen we een software timer gebruiken. We 
declareren een vertegenwoordiger met 


tim = Timer() 


De esp32 en de esp-c3 hebben vier hardware timers: 0, 1, 2 en 3. We declareren een 


vertegenwoordiger van timer n als 
Tim = Timer(n) 

Voor de ESP8266 is één timer beschikbaar. Je declareert hem met 
Tim = Timer(-1) 

De SAMD21 versie van MicrPython ondersteunt de timer (nog) niet. 


Verder werken met Timers 
We initialiseren de timer met methode init: 


tim.init(mode = Timer.PERIODIC) 
tim.init(mode = Timer.ONE SHOT) 
tim.init(freq = 1) 
tim.init(period=1000) 
tim.init(callback = tik) 


De mode bepaalt de toepassing: 


e Mode ONE SHOT: na één periode geeft de timer een signaal, een interrupt 
de het lopende programma onderbreekt om een functie uit te voeren. 

e Mode PERIODIC: de timer blijft lopen, na elke periode volgt een interrupt 
en begint alles opnieuw. 
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Callback bepaalt de functie die wordt uitgevoerd na een timerperiode 
freq of period bepalen na welke tijd de timerfunctie wordt uitgevoerd: 


e period = 1000: na elke 1000 ms 


e freq =1:één maal per seconde 


In het eerste voorbeeld gebruiken we een timer om een LED te laten flikkeren, één 
maal per seconde. 


timer-led.py 


12 december 2021 


H 
H 
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# Dirk Ghysels 


from machine import Pin, Timer 
led = Pin(25, Pin.OUT) 
ledAan = 1 


def tik(timer): 
global led, ledAan 
ledAan = 1-ledAan 
led. value(ledAan) 


#tim = Timer(1) #voor esp32 en esp32-c3 
tim = Timer(-1) #voor esp8266 
#tim = Timer() #voor rp2040 


tim.init(freq = 1, mode = Timer.PERIODIC, callback = tik) 


Elke seconde zal de timer functie tik oproepen, die verandert de status van de LED. 
Een volledige aan/uit cyclus duurt dus 2 seconden. 


Het resultaat voor de esp32-c3 is zeer onnauwkeurig. Op de website van MicroPython 
is hierover geen informatie te vinden. 


e lediseen globale variabele, die verwijst naar GPIO 25 als digitale uitgang. 
Globale variabele ledAan geeft aan of de LED al dan niet aan is. 

e in het hoofdprogramma definiëren we tim, een periodieke timer met 
frekwentie 1 Hz. De callbackfunctie is tik. De timer roept die één maal per 
seconde aan. 

e Functie tim verandert ledAan (O wordt 1, 1 wordt 0) en verandert daarmee 
de toestand van de LED. 
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Project KLOK 


De tijd berekenen 

Met een secondetimer kunnen we een klok programmeren. Functie klik verhoogt bij 
elke tik de secondenteller. Dat doen we tot 60, dan wordt de secondenteller nul en 
verhogen we de minutenteller. Daarna de urenteller, eventueel dagenteller, 
maandteller en jaarteller. We gaan uit van beginwaarden voor de tellers. Dat is een 
primitieve manier om de tijd in te stellen. Met enkele toetsen en een uitbreiding van 
het programma kan je dat verbeteren. 
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Shell - 


LU:21:46  — _ Z6/U2/2UZ1 E 

10:21:47 — 26/02/2021 

10:21:48 — 26/02/2021 

10:21:49 — 26/02/2021 

10:21:50 — 26/02/2021 mm 
v 


Figuur 87: Klok 


Het hoofdprogramma bestaat uit de laatste twee regels. Met klasse Timer maken we 
object tim, die initialiseren we in de laatste regel. Alle berekeningen gebeuren in 
interrupt routine tik. We tellen seconden tot 60, … Het aantal dagen van een maand 
is variabel, het programma houdt rekening met schrikkeljaren. Februari heeft 29 
dagen als het jaartal deelbaar is door 4. Een uitzondering is 2100, dat is geen 
schrikkeljaar maar daar houden we geen rekening mee. 


Met dit voorbeeld kan je met een MicroPython en een display mooie klokken 
bouwen. Er bestaan veel displays voor microcontrollersystemen. In dit project 
gebruiken we het 4-digit 7-segment display met seriële aansturing uit vorig 
hoofdstuk. 


Een klok met 7-segment display 

We maken de klok door vorige programma te combineren met de aansturing van het 
display uit vorig hoofdstuk. Het display toont alleen minuten en uren, datum kunnen 
we weglaten. 
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utime.sleep(1) 


def tik(timer): 
global sec, min, uur 
sec += 1 
if (sec==60): 
sec = 0 
min += 1 
if (min==60): 
min = @ 
uur += 1 
if (uur==24): 
uur=0 
print (“%92u:%02u" %(uur,‚min)) 
mydisplay.numbers(uur, min) 


mydisplay = tm1637.TM1637(clk=Pin(16), dio=Pin(17)) 

tim = Timer(1) #voor esp32 

ttim = Timer() #voor rp2040 

tim.init(freq = 1, mode = Timer.PERIODIC, callback = tik) 
buttonMin.irg (trigger=Pin.IRQ FALLING, handler=min handler) 
buttonUur.irg (trigger=Pin.IRQ FALLING, handler=uur handler) 


We hebben twee drukknoppen toegevoegd. ButtonMin, tussen GPIO14 en Vce stelt 
de minuten in, de tweede, tussen GPIO15 en Vee de uren. Ze genereren IRQ’s met 
handlers resp. min_handler en uur_handler. Om contactdender te vermijden, 
gebruiken we de schakeling van hoofdstuk Hardware Interfacing. De weerstand in 
die schakeling is de pull-up weerstand, de poort krijgt waarde O bij indrukken, de 
interrupt wordt getriggerd bij het nul-worden op de pin. 


De RTC van de controller 

Een RTC of realtimeklok is een computerklok, meestal in de vorm van een IC die de 
tijd bijhoudt. Een RTC heeft meestal een batterij zodat hij blijft verder werken, ook 
als de computer uit staat. Je vindt je deze klokken in alle soorten computers, ook in 
veel embedded systemen. Een veel gebruikt RTC-IC is de DS1307 van Maxim, die 
wordt ook verkocht als een module met batterij. 


Figuur 88: RTC, DS1307 


De meeste 32-bit controllers hebben een ingebouwde RTC. Die werkt onafhankelijk 
van de rest van de controller. De RTC berekent jaar (O … 4095), maand (1 … 12), dag 
(1 tot 28, 29, 30 of 31, afhankelijk van de maand), uur (O … 23), minuut (O … 60 en 
seconde (O … 60). Met sofware kunnen we de klok uitlezen en instellen. 
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De meeste computersystemen behandelen tijd als het aantal seconden sinds 1 
januari 1970, 0:00, UTC. (UTC=Greenwich tijd). De controller houdt die tijd bij in de 
RTC. Met klassen utime en RTC uit library machine zal MicroPython de RTC instellen 
en uitlezen. Voor de omrekening van tijdnotaties zijn er functies: omzetten van 
aantal seconden sinds 1/1/1970 naar jaar, maand, … minuten en seconden. 


Klasse RTC 
Deze klasse bestuurt de RTC. 


rtc = RTC() creëert een RTC-object. 

e rtc.datetime() geeft de huidige tijd als een tuple 

e Bijhet opstarten van een programma met Thonny, geeft Thonny de juiste 
waarden door aan de RTC. 

e Je kunt de RTC instellen met 
rtc.datetime((2017, 8, 23, 1, 12, 48, O, 0)) 
Dit is 23/8/2017, maandag, 12/48/0, O us. Let op: dubbele haken! 

e _ Library RTC is niet geïmplementeerd voor de SAMD21 


Het programma hieronder toont de tijd, éénmaal per seconde. 


Het programma hieronder werkt zonder aanpassingen op en RP2040, een ESP8266, 
een ESP32 en een ESP32-C3. 
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Shell 


21/06/2021 
21/06/2021 
21/06/2021 
21/06/2021 
21/06/2021 
21/06/2021 
21/06/2021 
21/06/2021 
21/06/2021 
21/06/2021 
21/06/2021 
21/06/2021 


Figuur 89: uitvoer van rtc-rp2040.py 


Klasse utime 
Met utime kan je de tijd opvragen en omzetten naar meer gebruikelijke vormen. 
Enkel functies van utime zijn: 


e _utime.time() geeft de tijd in seconden. Als je dat getal deelt door het aantal 
seconden per minuut, het aantal minuten per uur, het aantal uren per dag 
en het aantal dagen per jaar dan zie je het aantal jaren sinds 1 januari 1970: 


>>> y = utime.time() 
>>> print (y) 


1616666282 
>>> jaar = Y/60/60/24/365 
>>> print(jaar) 

51.26415 


Figuur 90: utime.time() 


e _utime.localtime() geeft de huidige tijd weer. In het voorbeeld hieronder zie 
je jaar, maand, dag, uur, minuut en seconde. Het laatste getal, 66 in het 
voorbeeld hieronder, zegt dat het nu in de 66°® dag van het jaar is. 


>>> time = utime.localtime() 
>>> print(time) 
(20245 3 Io ALT, 220 38160160 


>>> jaar = time[0] 
>>> print (jaar) 
2021 


Figuur 91: utime.localtime() 


e _utime.sleep(n) laat het systeem n seconden wachten. 

e _utime.sleep_ms(n) laat het systeem n milliseconden wachten. 

e _utime.sleep_us(n) laat het systeem n microseconden wachten. 

e _utime.ticks_ms() geeft de tijd inmilliseconden t.o.v. een onbekend 
beginpunt. Dat getal op zich betekent niets, maar met een verschil van twee 
ticks kunnen we tijdsintervallen meten. 


e _utime.ticks_us() is hetzelfde, maar in microseconden. 
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e _utime.ticks_diff(ticks1, ticks2) berekent de tijd tussen ticks1 en ticks2. 


Een klok, gebaseerd op de RTC en een 7-segment volume vind je hieronder: 


Hier gebruiken we knoppen om de klok in te stellen. Contactdender in deze 
toepassing zou heel vervelend zijn. Een druk op de minutenknop geeft meerdere 
pulsen, het aantal minuten worden verhoogd met 1, 2, 3 of meer. Het gelijkzetten is 
hierdoor bijna onmogelijk. Gebruik de schakeling uit hoofdstuk Hardware interfacing 
om contactdender te vermijden. 
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Opmerking: 


Na een stroomuitval en herstart geeft deze klok verkeerde waarden. Met een 
noodvoeding blijft de klok doorwerken. 
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